GETPW(3) | Linux Programmer's Manual | GETPW(3) |
名前¶
getpw - パスワード行エントリを取得する
書式¶
#define _GNU_SOURCE /* feature_test_macros(7) 参照 */ #include <sys/types.h> #include <pwd.h> int getpw(uid_t uid, char *buf);
説明¶
getpw() 関数は、バッファ buf に指定ユーザ ID uid の パスワード行エントリを取得する。 返されるバッファは、以下の形式の行を含む。
name:passwd:uid:gid:gecos:dir:shell
passwd 構造体は、<pwd.h> で以下のように定義されている:
struct passwd {
char *pw_name; /* ユーザ名 */
char *pw_passwd; /* ユーザのパスワード */
uid_t pw_uid; /* ユーザ ID */
gid_t pw_gid; /* グループ ID */
char *pw_gecos; /* ユーザ情報 */
char *pw_dir; /* ホームディレクトリ */
char *pw_shell; /* シェルプログラム */ };
この構造体のフィールドの詳細は passwd(5) を参照のこと。
返り値¶
getpw() 関数は、成功した場合 0 を返す; エラーが発生した場合 -1 を返し、エラーを 示すために error がセットされる。
エラー¶
ファイル¶
- /etc/passwd
- パスワードデータベースファイル
準拠¶
SVr2
バグ¶
getpw() 関数は、与えられたバッファ buf がオーバーフローするかもしれないので危険である。 この関数は getpwuid(3) によって古いものとなった。
関連項目¶
endpwent(3), fgetpwent(3), getpwent(3), getpwnam(3), getpwuid(3), putpwent(3), setpwent(3), passwd(5)
この文書について¶
この man ページは Linux man-pages プロジェクトのリリース 3.51 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。
2010-10-21 | GNU |